home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / gfx / pbm / ppm2AGA16.lha / ppm2AGA / doc / ppm2AGA.doc < prev    next >
Text File  |  1995-01-08  |  12KB  |  370 lines
  1.  
  2.                          ppm2AGA 1.6 by Günther Röhrich
  3.                          ******************************
  4.  
  5.  
  6. ppm2AGA ist a program for converting the ppm, pgm and pbm picture format into
  7. the IFF-ILBM format. For owners of an AGA-Amiga it is now possible to create
  8. high quality pictures without having to pay much money for a commercial image
  9. processing software. Together with the NETPBM-package it is possible to convert
  10. every other picture format and to do some basic image processing. If you want
  11. to convert PhotoCD pictures you will need the programs PhotoCDAGA or hpcdtoppm.
  12.  
  13. The advantages of ppm2AGA:
  14. - very high quality in the HAM8-mode
  15.   (better than some commercial programs)
  16. - processing pictures that are larger than the available memory is possible
  17. - saving to the Clipboard is possible
  18. - colormaps with full 24 Bit color precision are supported
  19. - the source is available
  20. - runs on all Amiga's with all processors  (even with KS 1.2/1.3 if
  21.   iffparse.library V37 is available)
  22. - you can create AGA pictures on non-AGA machines
  23.  
  24.  
  25. This program is Freeware with the following restrictions:
  26.  
  27. Some parts of the program are taken from the NETPBM-package and are therefore
  28. Copyright (C) 1989, 1991 by Jef Poskanzer. These parts are heavily modified.
  29.  
  30. This is allowed by the original author as you can read in the following text
  31. written by him:
  32.  
  33. Permission to use, copy, modify, and distribute this software and its
  34. documentation for any purpose and without fee is hereby granted, provided
  35. that the above copyright notice appear in all copies and that both that
  36. copyright notice and this permission notice appear in supporting
  37. documentation.  This software is provided "as is" without express or
  38. implied warranty.
  39.  
  40. If you modify or redistribute ppm2AGA you have to take care of this
  41. permission notice. The files in the directory "Developer" are written
  42. completely by me and they are therefore not covered by the copyright notice.
  43. You can do what you want with them.
  44.  
  45.  
  46. I have to thank the following persons:
  47.  
  48. Jef Poskanzer (jef@well.sf.ca.us):
  49.  for the development of the ppm-format and the pbm-software
  50.  
  51. Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de):
  52.  for the Amiga-specific parts of NETPBM and for ppmtoilbm.c
  53.  
  54. Johan Widen (jw@jwdata.se):
  55.  for the chunky->planar conversion routine in ppmtoilbm.c
  56.  
  57. Paul Heckbert:
  58.  the color quantizing routine in ppmquant.c is based on his article in
  59.  "SIGGRAPH '82 Proceedings", p. 297
  60.  
  61. The Independent JPEG Group (jpeg-info@uunet.uu.net):
  62.  for the source for decoding/encoding the JPEG-format
  63.  
  64. ***********************************************************************
  65.  
  66. I have created two versions of the program:
  67.  
  68. ppm2AGA.000 for 68000 and 68010 processors, it runs on all others too
  69. ppm2AGA.020 for 68020 or higher processors
  70.  
  71. I don't know if the 68000-version works because I don't have a 68000-based
  72. Amiga to test it. As operating system you will need OS 1.3 or higher.
  73. (With OS 1.3 you will need iffparse.library V37 which is available on the
  74. Workbench 2.0 disk.)
  75.  
  76. NOTE: Newer versions of ixemul.library (40.xx) don't work any more with
  77. Kickstart 1.2/1.3.
  78.  
  79.  
  80.  
  81. Invoking ppm2AGA:
  82.  
  83.   ppm2AGA inputfile outputfile options
  84.  
  85.  
  86. inputfile
  87. *********
  88.  
  89. The name of the file that should be read. Supported picture formats are:
  90. PPM - color, 24 bit/pixel (16Meg colors)
  91. PGM - greyscale, 8 bit/pixel (256 greyscales)
  92. PBM - black/white, 1 bit/pixel
  93. Both binary and ASCII formats are accepted. More informations can be found
  94. in the NETPBM-package.
  95.  
  96.  
  97. outputfile
  98. **********
  99.  
  100. This is the name of the IFF-ILBM file that should be created. If you use -cn
  101. as a name then the file will be written to the Clipboard with unit number n.
  102. (You should normally use unit number 0.)
  103.  
  104.  
  105. options
  106. *******
  107.  
  108. All options are case-insensitive. If they are not set then internal default
  109. values will be used.
  110.  
  111.  
  112. -HAM8 (default)
  113.  
  114. Use the HAM8 conversion method. This allows a total of 262144 different colors
  115. for the created picture.
  116.  
  117.  
  118. -HAM6
  119.  
  120. Use HAM6-mode. The quality is not very good (compared to other programs). The
  121. created picture may have max. 4096 colors.
  122. mode.
  123.  
  124.  
  125. -CMAPn
  126.  
  127. Use the colormap conversion method with n bitplanes. (max. 8) The created
  128. pictures will have max. 2^n colors out of about 16 millions.
  129. If you display the picture on an ECS/OCS machine with the original hardware 
  130. then the picture will not show the original colors because these machines only
  131. support a color selection out of 4096 colors.
  132. You can use the -FS option with this mode.
  133.  
  134.  
  135. -E
  136.  
  137. (Only for use in combination with the -CMAPn option.)
  138. Use this option when you know that the ppm-file has a limited number of colors.
  139. (less than 10000) This is for example the case when the ppm-file results from
  140. a colormapped picture format like GIF, BMP, etc.
  141. This option ensures that the original colors will be preserved. When converting
  142. the pgm-format this option will be set automatically because pgm-files have max.
  143. 256 greyscales.
  144.  
  145.  
  146. -FS
  147.  
  148. Use Floyd-Steinberg dithering. This may enhance the picture qualitiy.
  149. When used with the HAM8-mode the enhancement will not be that much.
  150.  
  151.  
  152. -Mx
  153.  
  154. Load pictures up to size x (in bytes) into memory. (default: 1000000)
  155.  
  156.  
  157. -2 
  158.  
  159. Use two-pass processing in the HAM6/HAM8 mode. This gives slightly better
  160. results. With digitized pictures you will not see any difference in most
  161. cases.
  162. (Version 1.0 of ppm2AGA always used two passes.)
  163.  
  164.  
  165. -D
  166.  
  167. Display the picture during processing. You need OS 3.0 or higher. If the
  168. screen cannot be opened processing will continue without display. To move
  169. the screen around with the mouse you have to activate it first. It also
  170. has a hidden drag bar and depth gadget. 
  171.  
  172.  
  173. -VGA
  174.  
  175. The picture will always use the VGA screenmode (also called 'multiscan').
  176. If your machine does not support this mode you will have problems showing
  177. the picture. Use this option when you know that the picture was intended for
  178. displaying on a PC or other machines with quadratic screen resolution.
  179.  
  180. NOTE: With 'quadratic' I don't mean that the screen has the same number of
  181. pixels in horizontal and vertical direction. (e.g. 1024x1024)
  182. I mean that a square composed of e.g. 100x100 pixels will be shown as a
  183. square on the screen. Because a usual picture tube has a ratio of 4 to 3
  184. the screen's resolution must be a multiple of that. (e.g. 640x480 because
  185.  
  186.  640   4
  187.  --- = - )
  188.  480   3
  189.  
  190.  
  191. -SMR
  192.  
  193. When setting this option you can use a screen mode requester to choose the
  194. display mode. But you can choose only display modes that are available on your
  195. machine. You will also need Workbench 2.1 or higher.
  196. The options -HAM8, -HAM6, -CMAPx and -VGA will be ignored if they are set.
  197.  
  198.  
  199. -jpegAGA
  200.  
  201. Instead of an IFF-ILBM file a map-file for the program jpegAGA/PhotoCDAGA will
  202. be created. Normally, map-files are created by using a shell script. See the
  203. documentation to jpegAGA/PhotoCDAGA for more.
  204.  
  205. If it is not possible to store the map-file in the specified place (for example
  206. if the storage media is full or write protected) then the map-file will be
  207. stored into the directory pointed to by the MAPDIR environment variable.
  208. jpegAGA 1.1 or higher will also search the map-file in that place, same with
  209. PhotoCDAGA.
  210.  
  211.  
  212. -b Name
  213.  
  214. Create a map-file with the base-name "Name". This is useful when creating map-
  215. files for the program PhotoCDAGA. (see there for more) The environment variable
  216. MAPDIR also must be set.
  217.  
  218.  
  219. If you don't know what options to use to get the best quality make three
  220. conversions with the options: -HAM8 -FS, -CMAP8, -CMAP8 -FS and compare the
  221. results.
  222.  
  223. There is also a JPEG decompression program included. It converts JPEG
  224. pictures to the ppm format. To use it enter:
  225.  
  226.  djpeg inputfile outputfile
  227.  
  228. In some cases djpeg will try to store temporary files to JPEGTMP:, you
  229. have then to assign this directory to somewhere on your hard disk.
  230. (for example assign JPEGTMP: HD:T)
  231. For more informations read the included documentation.
  232.  
  233.  
  234. How the program works
  235. *********************
  236.  
  237. Not translated into English yet. Read the German documentation.
  238.  
  239.  
  240. Questions and answers
  241. *********************
  242.  
  243. Not translated into English yet. Read the German documentation. :-(
  244.  
  245.  
  246.  
  247. History
  248. *******
  249.  
  250. 1.0 - 19-Apr-1994
  251.     
  252.     - first public release
  253.  
  254.  
  255. 1.1 - 5-May-1994
  256.  
  257.     - added -2 option
  258.     - one-pass processing is now the default in HAM6/HAM8 mode
  259.       (use the -2 option to get the same results as version 1.0)
  260.     - added -D option to display the picture during processing
  261.     - the documentation now contains my correct EMAIL-address
  262.  
  263.  
  264. 1.2 - 15-May-1994
  265.  
  266.     - autoscroll bug fixed (forgot to set the SA_Overscan Tagitem)
  267.     - added -VGA option
  268.  
  269.  
  270. 1.3 - 4-June-1994
  271.  
  272.     - added -jpegAGA option for creating map-files for the program jpegAGA
  273.  
  274.  
  275. 1.4 - 6-October-1994
  276.  
  277.     - added support for the MAPDIR environment variable to be conformant with
  278.       jpegAGA 1.1 or higher
  279.     - you can now use Floyd-Steinberg dithering in the HAM8-mode
  280.     - added -SMR option to let you choose the screenmode much better
  281.  
  282. 1.5 - 19-November-1994
  283.  
  284.     - fixed a possible Enforcer hit
  285.     - added option -b Name as needed by PhotoCDAGA
  286.  
  287. 1.6 - 8-January-1995
  288.  
  289.     - the picture screen will be set to the background before closing it
  290.     - pictures in HAM6 mode are now shown correctly on AGA machines
  291.     - when HAM pictures are moved around the errors at the left side will be
  292.       much smaller
  293.  
  294.  
  295. Announcement
  296. ************
  297.  
  298. The actual version of this program does not offer very much. My spare time
  299. is very limited because I am now studying Electrical Engineering at the Uni-
  300. versity Stuttgart. Therefore I am searching for other developers to cooperate
  301. with me and beta-testers for testing purposes. If you want to join in then
  302. please contact me. I will then create a detailed description of the source.
  303.  
  304. To recompile the source you need the newiff package from Commodore.
  305. V37 is available on Fish-disk 705 and V39 on the "3.1 Amiga Developer Update"
  306. disks. (Or on Aminet and on the Fresh Fish CD-ROM's.)
  307. If you find a bug, a Mungwall/Enforcer hit, or if you have some suggestions
  308. for additional features then send me a message.
  309.  
  310. Future plans:
  311. - PhotoCD viewer/converter with the picture quality of jpegAGA/ppm2AGA
  312.   (This is already done :-)
  313. - graphical user interface
  314. - support for animations, especially converting MPEG to IFF-ANIM in HAM8 mode
  315. - support for other picture formats and basic image processing
  316.   (scaling, clipping, etc.)
  317. - ARexx-port
  318. - documentation in TeX-DVI and AmigaGuide format
  319. - complete (and correct) translation of the German documentation
  320. - fast ppm-viewer using the HAM8-mode with fixed colormap and doubled horizontal
  321.   resolution for higher quality, perhaps as datatype
  322.   (If you don't understand what I mean then send me a note)
  323. - using the colormap from other pictures instead of computing it
  324. - etc.
  325.  
  326. Next project: jpegAGA 2.0, with following new features:
  327. - based on IJG JPEG V5 code (instead of V4)
  328. - high speed scaling, can be used for VERY fast preview
  329.   (only a few seconds even for large JPEG's)
  330. - little bit faster
  331.  
  332.  
  333. All messages/gifts/etc. should be sent to the following addresses:
  334.  
  335.  
  336.   electronic mail:                                  normal mail:
  337.   ****************                                  ************
  338.  
  339.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  340.      (Internet EMAIL)                               Lerchenbergstr. 4
  341.                                                     73733 Esslingen
  342.                                                         Germany
  343.  
  344.  
  345. If you don't get an answer to a EMAIL within 3 weeks then try it again
  346. with normal mail.
  347.  
  348.  
  349. Here is how to get all the stuff I mentioned in the doc:
  350. ********************************************************
  351.  
  352. The NETPBM-package and the JPEG-source are available via FTP.
  353. (for example from ftp.uni-stuttgart.de)
  354.  
  355. NETPBM: ftp.uni-stuttgart.de in aminet/gfx/pbm
  356.         (or on all the other Aminet mirrors)
  357.         ftp.uni-oldenburg.de in ?
  358.  
  359. JPEG:   ftp.uu.net in graphics/jpeg
  360.         (or on Aminet in gfx/conv)
  361.  
  362.  
  363. If you have no other possibility you can get everything directly from me.
  364.  
  365. In the document "Info.Developer" you can read how to get other developer
  366. material, especially the "3.1 Amiga Developer Update".
  367.  
  368. NOTE: Commodore does not exist any more, I don't know if it is still possible
  369. to get developer materials. Try to contact the German company Hirsch & Wolf oHG.
  370.